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Preface 


While at the Air Force Institute of Technology (AFIT), 
other students and I experienced sheer frustration when we 
tried to analyze or design a control system using the 
separate computer programs that were available. The input 
and output formats for each program were different and, at 
times confusing, and each program had to be attached 
separately, then executed, and finally returned before 
another program could be used. The Air Force Flight Dynamics 
Laboratory (AFFDL) personnel expressed the same feelings of 
frustration when using these programs. So, I have plunged 
head-strong into the task of combining as many control design 
programs as possible into a “usable” program for control 
systems design and analysis. Given another two years, I 
probably could have been successful. However, the comments 
that I have received from persons using the "separate” 
programs and the new “consolidated” program have indicated 
that my efforts were not all in vain. 

I am sure that I had become somewhat of a pest to 
Professors C.W. Richard, Jr., T.E. Reeves, and G. Orr, and I 
wish to publicly thank them for their patience with me, and 
for their competent suggestions and directions. I wish also 
to thank Dr. Gary B. Lamont for taking a special interest in 
my task, and for encouraging me to try to accomplish it. 


Similar thoughts of thanks go directly to Frank George of 


Li 
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¢ APFDL for sponsoring my thesis. 

Finally, but in no way least, I wish to thank God for 
helping me, and my wife, Barbara, and my children, Noelle 
and Kathy, for being so understanding and for giving me 
encouragement when I really needed it. 

I will confess that some errors may appear in this 


report, and I take full responsibility for these errors. 


Prederic L. O’Brien 
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ABSTRACT 


Several different computer programs have been independent- 
ly developed for control system design and analysis. Each 
program may have its own input and output formats (different 
from any other), and each program may have its own operating 
philosophy. This report describes a Consolidated Computer 
Program for Control System Design (CCPCSD) and its development: 
specifications, organization, realization, testing, and results. 

The CCPCSD contains four previously written Air Force 
Institute of Technology (AFIT) computer programs for control 
system design algorithms (ROOTL, PARTL, FREQR, and POLY) and a 
lead-in program which controls the overall flow of the CCPCSD. 
An overlay structure is used. The structure consists princi- 
pally of an executive (main) overlay and four primary overlays 
(one for each subprogram mentioned above). Each subprogram is 
modified towards standardizing inputs, termination procedures, 
and data structure (where feasible). 

The CCPCSD is developed to be used by control systems 
engineers and/or AFIT engineering students. A user-oriented 
approach permeates the entire program. This computer-aided 
design tool can be operated from an intercom terminal, where 


operator-computer interaction takes place. 
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A CONSOLIDATED COMPUTER PROGRAM 


FOR CONTROL SYSTEM DESIGN 


I. Introduction 


One of the most important present-day tools for either 
designing or analyzing control systems (continuous or 
digital) is the computer. Computer programs have been 
written to aid the engineer or student in the sometimes 
awesome task of designing or analyzing control systems. It 
seems that individual programs are willingly written as the 
need arises, but with little, or no thought about future 
needs (i.e., ...for combining several individual programs 
for one large, consolidated task...or more specifically, 
for combining a root locus program, a frequency response 
program, and a time response program so that a control 


system can be analyzed completely.). Well structured 


consolidated computer programs are definitely in great demand 


by engineers and students alike, but these programs do not 
seem to be available (or, quite possibly, the programs have 
been written, but are made available only to personnel in 


small unexposed offices, firms, or organizations). 


Background 
Prior to, and including the time this thesis was 


written, computer programs stored in the AFIT computer 


library of the CDC 6600 computer system, and the Electrical 
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Engineering Department were made available for use of 
personnel at the Air Porce Institute of Technology (AFIT), 
building 640. The library and Electrical Engineering 
Department possess a variety of control system design and 
analysis computer programs (continuous and digital), such 
as ROOTL (Root Locus Program), FREQR (Frequency Response 
Program), PARTL (Partial Fraction Expansion and Time Response 
Program), POLY (Roots of Polynomial Function), DIGIS 
(Z-Transforms), FIR (Finite Impulse Response Filter Design), 
OPTCON (Optimal Control Design), and others, no doubt, that 
are still part of some professor's "private stock." 

There are also other specialized design and analysis 
computer programs available at the Flight Dynamics Laboratory 
and at the Aeronautical Systems Division of Wright-Patterson 
Air Force Base, Ohio. DIGICON ("Digital Flight Control 
Systems for Tactical Fighter," AFFDL-TR-74-693; computer 
algorithm for the design of the digital control systems of 
the F-4 Aircraft) is one of the specialized programs that 
are available. 

Further, there are programs that are available for 
control system design and analysis that have been written to 
fulfill master's, or doctor's degree requirements. One such 
program is "The Design of Automatic Control Systems Using 
Interactive Graphics," by Kenneth R. Young, which allows a 
user an advantage of working interactively with the computer 
(real time) for control system work. The Air Force has also 


contracted industry for specialized computer programs. 
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All in all, many computer programs that could be used 
for control system design and analysis are available. The 
engineer and/or student would like to be able to use these 
programs---computer-aided design tools. Hence, a statement 


of purpose for this thesis is presented. 


Statement of Purpose 

The professional control engineer and/or the control 
engineer student are, of course, saddled with the task of 
designing and analyzing control systems. Computer-aided 
design and analysis tools are an important contribution to 
the timely success of completing the design and analysis of 
a control system. To adequately perform the design and 
analysis task, the control engineer must have at his 
disposal (as a minimum) a root locus, a frequency response, 
and a time response. The characteristics of the control 
system are shown by these three methods, and these then 
enable the designer to analyze the complete performance of 
his basic system. There are also extensions to these design 
and analysys techniques (Nichols Chart design and Nyquist 
design are two of these extensions) that are also available, 
but the root locus, the frequency response, and the time 
response are still considered as the principal methods for 
control system design and analysis. And, as previously 
mentioned, three AFIT computer programs (ROOTL, FREQR, and 


PARTL) are already available, and they provide these basics 


(root locus, frequency response, and time response). 


GE/EE/76D-38 


Hence, the purpose of this effort is to clearly develop, 


by at least one means, a computer-aided design tool for 


control engineers and students which contains as an absolute 
minimum four AFIT programs that are presently available for 
control system design (ROOTL, FREQR, PARTL, and POLY). This 
tool must be a computer program that shall be called the 
Consolidated Computer Program for Control System Design i 
(CCPCSD). It must be capable of providing an engineer or 

student with repeated access to one, two, three, or all of 


these programs mentioned - all during one sitting at the 


terminal. The capability must exist for the operator to be 


in full control when selecting and using these programs. 


An architecture must be developed which allows adding some 


other programs, without requiring extensive modification to 


either the consolidated program or the program being added. 


Therefore, the CCPCSD must be a useful, versatile, self- 


contained computer program - capable of being operated by 


experienced engineers or beginning student engineers. 


General Approach 
The approach that was taken towards the objective of 


providing a good computer-aided design tool for control 


engineers might best be thought of as a “general engineering 


approach,” in that: 1) information pertaining to the problem 


has to be researched, and specifications have to be fully 


determined; 2) the researched information has to be evaluated 


so that decisions can be made about the capabilities and 


trade-offs that would influence the overall organization of 


Ty 
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the problem solution; 3) the organized solution, in this case 


an algorithm, has to be realized in a computer program; 4) 


the program has to be test; and 5) the results, conelusions, 
and recommendations have to be stated. 

This report covers this approach in the following manner. 
Chapter II includes the definition of the specifications and 
the actual method taken to achieve the task. The organization 
of the CCPCSD is discussed fully in the chapter, along with 
a discussion concerning the standardization of the program 
inputs and termination procedures, and the data structure. 
Chapter III shows the process of realizing the total algorithm 
as an efficient, error-proofed computer program. The chapter 
also discusses the testing criteria and methods, and the 
results obtained from the testing. Finally, Chapter IV 
summarizes the effort with a presentation of conclusions and 
recommendations. The appendixes contain a description of 
the programs ROOTL, FREQR, PARTL, and POLY; a user's guide 
for the CCPCSD; a source listing for the CCPCSD; and a 


procedure for adding programs to the CCPCSD. 


Highlights of the CCPCSD Program Operation 
From a terminal (teletype or CRT display), the CCPCSD 


program can be attached from the library, and executed by 
following the printed instructions as they appear. Now to 
look at the program operation from an operator's point of 
view. 


First of all, an operator must state that he is at a 
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terminal. Typing "TTY" and returning the carriage 
accomplishes this task. Next, and explanation of the program 
is provided; the operator may select or reject this option. 
The explanation is intended to be used for either an initial 
declaration of the program, or as a recall for review. For 
each case, the explanation tells the general sequence of 
events that occurs. 

The program 
that the roots for the numerator and denominator polynomials 
of the transfer function, G(s), can be found. The operator 
may not need to use this option, and he can type "NO" to move 
on. 

The next part of the program is very important. A list 
of the subprograms (ROOTL, FREQR, PARTL, and POLY) is printed 
out along with a brief explanation of each subprogram. To 
conserve paper and time, the list is printed out only one 
time; hence, the operator must jot down the symbolic name for 
each of the subprograms for use then and later in the 
program. (This decision for a one-time printout of the list 
is based upon previous irritating experiences with other 
programs, in which long lists of options were printed out 
repeatedly throughout the program. Hopefully, copying down 
the list of subprograms is not too inconvenient.) Now 
the operator can select the subprogram he wishes to use. 
(Appendix A may be referred to for a description of the 
individual subprograms. ) 


After the operator has provided the inputs required 
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for the subprogram he chose, and obtained the output that he 
desired, the program allows the option to either continue 
with the presently chosen subprogram, choose another subpro- 
gram, or stop. Each time the operator is finished working 
with any subprogram, these above options are presented. 

Hence, the highlights of the CCPCSD program (from an 
operator's point of view) have been presented to show the 
sequential arrangement of specific functions that are 
accomplished by the CCPCSD. Chapter II follows with an 
in-depth discussion of the CCPCSD program. 
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II. Development of the Consolidated 
Computer Program for Control System Design 


Chapter I presented a general overview of the effort 
to develop a consolidated computer program for control system 
design. This chapter expounds further upon the areas 
concerning the specifications and organization discussed in 
the general approach. A substantial amount of effort is 
devoted to discussing the specifications and requirements 
that afforded the finalized approach that was taken. Next, 
the overall organization of the program is explained, and 
the make-up of each of the overlays is described. Some 
discussion is devoted to the standardization of inputs and 
program/subprogram termination procedures, and, finally, 
pertinent comments relating to the data structures of the 


subprograms are stated. 


Specifications and the Actual Approach 


The theme of this section of Chapter II is to discuss 
the specifications and the approach taken. The specifications 
are based upon specific needs, or requirements. Discussing 
(in terms of the needs or requirements) the means that are 
available to meet each need allow choosing the best way to 
proceed - the approach. The approach, when carried out fully, 
meets the intended goal of “providing a unified package of 
computer algorithms (consolidated computer program) for 
in-house, or acamemic analysis and conceptual design of 


control systems...contained totally within itself...capable 
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of enabling user interaction with the computer...one-time | 
program use with one-time input (satisfying all computer 
algorithm input requirements)...useful outputs, such as 

root locus, frequency response, and time response, for control 
system design and analysis.” This goal is the sole directing 
force for this important section, and prior to discussing the 
specifications, certain constraints and factors are exposed 


below. 


Constraints. The following constraints place certain 


restrictions on the approach and the goal: 


a. use of CDC 6600 computer only; maximum core 
available for intercom jobs is 50,000g words. 
(Reference 2 and 3) 

b. computer language must be Fortran IV (Extended) 
(Reference 1) 

ce. input requirements must be simple and user-oriented. 

d. output requirements must be complete and useful 
(in a format easy to analyze from a control systems 
point of view) 

e. maximum amount of plots, printouts, or data stored 
must be within the 50,000g word core requirement. 
(program + data storage = 50,000g words maximum) 

f. program must allow user interaction (terminal or 


ert) 


Factors. The constraints that are imposed demand certain 


factors to be addressed. 


GE/EE/76D-38 


a. A good understanding of the CDC 6600 computer 
must be acquired. Terminology and appropriate 
input and output requirements and formats must be 
understood to be able to communicate with the 
computer. Correct codes relating to syntax and 
semantics must be understood and applied 
efficiently. 

b. Knowledge about the Fortran IV (Extended) computer 
language must be sought, along with a proficiency 
in using it to write programs. A knowledge of 
overlays and overlay structure is required in order 
to put a consolidated program together and conserve 
on core usage. 

c. A good knowledge of control system design and 
analysis terminology and techniques must be 
acquired, along with a valid approach towards 
properly analyzing and designing control systems. 

d. Research must be conducted to determine what 
computer algorithms are presently available, what 
function(s) they perform, what input and output 
requirements they demand, and what type of data 
structure they use. 

Knowing now what constraints and factors were imposed 
initially, the specifications can unfold. 

input and Outputs Requirements for Programs Available. 
After reviewing the programs (algorithms) mentioned in 


Chapter I, it was decided that initially the programs ROOTL, 


| 
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FREQR, PARTL, and POLY would be chosen as basics to make up 

a consolidated program. The rationale being that these 
programs, when used together, are very capable of providing 
sufficient data, in a useful format, to design and analyze 
control systems. And, although FREQR and ROOTL are capable 
of performing some digital system analysis, a “first step" 
would be to develop the consolidated program to handle 
continuous domain systems only. Tables I and II indicate, 
respectively, the characteristics of each of the programs, and 
the input requirements of each of the programs. 

Also worth noting, the “first step" would consider the 
capability to operate the consolidated program from an 
intercom terminal. BATCH and interactive graphics capabilities 
could follow later. Rationale - interactive graphics is 
considered “ideal” in that the engineer interacts with the 
computer in a real-time environment, and he "creates" his 
design and analysis at the graphics terminal. Root locus, 
time response plots, and frequency response plots are displayed 
on the graphics console, and the engineer may make changes 
to his system, or accept the design he has created. The key 
advantage to the interactive graphics approach is that the 
engineer can “see” what is happening in real-time. But, even 
though it is considered “ideal,” it is a very complex and 
time consuming job which is beyond the scope of this thesis. 
Intercom operation is preferred by engineers and students over 


BATCH jobs,in that it, like the graphics, enables the operator 


to act interactively with the computer (input the parameters, 
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Table I 


Characteristics of Programs 

ROOTL, FREQR, PARTL, and POLY 
Characteristics Srogrens {kigere ae 
of each Program ROOTL 


FREQR PARTL POLY 


“~-~ 
Oss 
so 

Wn @ 
oo 
seals | 


Frequency Response 


Time Response 


Time Function 
Partial Fraction 
Expansion 


Roots of polynomial 


Printer Plot 
Calcomp Plot y 


«++ Type System... 


Continuous yes yes 


Digital 


yes no 

Listing yes yes 

FTY Plot yes 
es 


o 
a 


part. 
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Table II 
*Input Requirements for Programs 
ROOTL, FREQR, PARTL, and POLY 
*NOTE: Table II shows the different “ways" the input parameters 
are “asked for." The symbol "N/A" indicates that the program 
does not explicitly "ask" for that parameter, but the program 


may implicitly require the parameter. Hence, at times three 
different ways of entering the same parameter may occur. 


Input Requirements Programs (Algorithms) 

For Each Program ROOTL FREQR PARTL POLY 

Polynomial: Numerator yes yes 
Denominator yes yes 


Numerator: 
No. Factors Given Order 
Order of Factors 

Coefficients Numerator 


Denominator: 
No. Factors Given Order 
Order of Factors 
Coefficients Denominator 


Real/Imaginary Factors: 
Numerator 
Denominator 


Initial Omega (w) 
Incremental Omega (w) 


Restart Array 


Time Delay, exp(-Ts) 
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Table II cont. 


Input Requirements Programs (Algorithms) 
Por Each Program ROOTL PREQR PARTL 


Magnitude Plot N/A yes N/A N/A 
Log-dB Plot N/A yes N/A N/A 
Titles yes yes 
Sampling Period cz yes 


Right Bound 


i" 
° 
els 
° 


no no 
no no 
no no 
no no 


Dist» Between Plot. Pts. 
Sensitivity, K | yes | 


: 


N 


yes 
yes 
yes 
iaitiat Sip i va_| wh 
Imag. Part Init. Test Pt 
Number Pts. to be Called 

yes 

yes 

yes 

es 


Delete Tnsfr Function |yes | 
Multiple Graphs | yes | 


Plot Destination 


Zl 
>|§ 


2/2/24 =z 


yes 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
yes 
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see and analyze the printed out results, and continue or 
stop), but to a lesser degree. The intercom operation is 


not as difficult to program. 


Data Structure. The specifications for a data structure 
to be incorporated into the consolidated computer program 
must be such that the following criteria can be met: 

ae One structure for input datas the structure must 
be capable of being used by all programs 
simultaneously, thus allowing an operator to put 
input data in one time, but use any or all of the 
programs. 

b. The structure must allow changing of only the 
data wished to be changed by the operator without 
altering the data entered previously. 

c. The structure must allow future addition of 
programs - extending the amount of data stored 


without changing the data structure. 


d. The structure must allow data to be read out, but 
not destroyed. 

e. The structure must allow certain output parameters 
from one program (i.e., the roots from program 
POLY) to be stored as input parameters for another 
program (i.e., stored as the numerator or denomin- 
ator factors of ROOTL). 

Data management is very important, especially as the 


amount of core required for each program to be added becomes 


a critical factor. 


15 
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Of the basic techniques for data management that were 
researched, four seemed applicable for the consolidated 
program, and they are discussed below. 

a. Mass storage input/output subroutines for the CDC 
6600 computer system allow the creation, access, 
and modification of multi-record files on a random 
basis, and does not depend upon the file's 
physical position or internal structure. A good 
point is that each record in the file, when either 
read or written into at random, does not have its 
other contents affected. This type of file 
storage is consistent with the idea of changing 
only certain parameters rather than all parameters 
of a system. Although this method of data 
management seemed almost ideal, it is not neces- 
sarily an optimum choice for input/output use in 


the consolidated program (could be tailored), and 


furthermore, it was nearly impossible to locate 
persons who would recommend this approach. 
b. A second data management approach is the use of 

the NAMELIST statement. The NAMELIST statement 

permits the input and output of groups of variables 
| (i.e., poles, zeros, constant) and arrays with a 

unique name. Key points of the NAMELIST data are: 

(1) a variable or array name may belong to one or 

more NAMELIST groups, (2) specific parameters in a 

NAMELIST group may be changed without altering any 


16 
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of the other parameters, (3) when entering data, 
f the NAMELIST group name must be preceded by a $ 
(dollar sign), and after all of the data has been 
entered, another $ must be used as a termination. 
The use of the NAMELIST statement is a familiar 


method for use as a data management tool. 


strings of vectors (one-dimensional arrays) are 


vector must be assigned as a specific parameter 


location (Fig. 1). These positions can have data 


Real poles in positions 
XP(1) through XP(N). 


Imaginary poles in positions 
YP(1) through YP(N). 


Fig. 1 


Example of Vectors (One-Dimension 


Arrays) for Data Management 
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c. Where only single-valued parameters are manipulated, 


adequate for data management. Each position in the 
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Example of Two-Dimensional Array (Order of Entry) 
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(specific) read into them, or removed for 
calculations and returned again. The key point 
being that the program must keep “record” of each 
position - putting in, or taking out only when 


needed. 


d. Two-dimensional arrays may also be used in the 


same manner as the one-dimensional arrays. The 
number of words reserved for the array will be 
determined by the number of elements in the array, 
and the number is figured by the product of the 
array subscripts (i.e., A(3,3)= 3 x 3 = 9 words). 
The use of the two-dimensional array requires pre- 
planning of the parameter positions as well as 
exact data control (entering and retrieving data) 


by the program (Fig. 2). 


Fig. 2 
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In view of the four methods of data management that have 
been described, methods b and c are chosen for the consolidated 
program - ROOTL already utilizes the NAMELIST statement; FREQR, 
PARTL, and POLY already utilize the vector storage method. 

And, considering the "first Step" approach to a usable 
consolidated program, these data structures are to remain 
relatively unchanged. 

Method of Combining Programs. Remembering the chief 
constraint of having available only 50,000g words of core for 
intercom use, the method for combining the programs ROOTL, 
FREQR, PARTL, and POLY is limited to the use of overlays and 
overlay structure only. By using the overlay structure, the 
amount of core required is reduced (only part of the total 
consolidated program would be in the memory at one time), and 
field length is used more efficiently. The details and 
explanation of the overlay structure is given later in this 
chapter as the organization of the CCPCSD is discussed. 

Final Approach. The final approach takes into consider- 
ation the knowledge (of the writer) that is at hand, the goal 
to “develop a unified package...," the time element for 
completion, the availability of the computer and computer 
time, and the specifications that are pertinent to describe 
a consolidated program. Hence, as a "first step," the programs 
ROOTL, FREQR, PARTL, and POLY are to be put together into a 
consolidated computer program which is then, as a minimum, 
capable of performing each task (root locus, frequency 


response, time response and roots of a polynimial) for a 
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continuous domain control system design and analysis. The 
consolidated program is to be user-oriented, allowing the user 
to control the destiny of the control system he is designing 
and analyzing by choosing whichever program he wishes 
(repeatedly, if necessary). The programs are to be modified 
to fit in a usable architecture of overlays, and the data 
structures and input/output requirements presently used 
within each program are to remain in effect, unless glaring 
discrepancies, or conflicts arise. The major intent is to 
standardize operations and instructions ‘nerever possible. 

It must be understood that the "first step" finished product 
shall be definitely useful, but certainly not as optimal of a 
solution as might be desired. However, the time and efforts 
of another interested individual may be channeled towards the 


goal of optimizing the "first step." 


Organization of the CCPCSD 

Again, to strive to reduce the actual amount of core 
that is required for the program, and to make more efficient 
use of field length, an overlay structure is used. The 
executive (main) overlay and the individual subprograms 
(primary overlays) make up the overall program structure. In 
general, as shown by Fig. 3, the primary overlay of ROOTL 
contains subroutines pertinent to the primary overlay, and 
also contains secondary overlays which have within their 
structure other subroutines pertinent only to the secondary 


overlay. 
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Overlay (0,0) 
(Main overlay) 


II////////// Subprogram Overlays ///////////////// 
///ROOTL////////PREQR///////PARTL////////POLY///// 


Overlay Overlay Overlay Overlay 


Program 
ROOT10 


Overlay 
(CCPCSD,1,1) 


Program 
ROOT11 


Overlay 
(CCPCSD,1,2) 


Program 
ROOTS 


Overlay 
(CCPCSD,1, 3) 


Program 
ROOT12 


Fig. 3 
Overlay Structure of the CCPCSD 


Executive (Main) Overlay (CCPCSD,0,0). The executive 


overlay remains in core at all times, and controls the over- 
all flow of the program. The program statement for Overlay 
(CCPCSD,0,0) specifies the file names that are used throughout 
the CCPCSD; i.e-, INPUT=100B, OUTPUT=100B, ANSWER, PPLOT, PLOT, 
CFILE, TAPE5=INPUT, TAPE6=ANSWER, TAPE7=OUTPUT, TAPE8=PPLOT, 


and TAPE9=100B. File names do not appear in any other overlay. 
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And, of course, Overlay(CCPCSD,0,0) precedes all other 
overlays. 

The executive overlay provides the following questions, 
with subsequent direction consistent with the response of the 
operator: 

a. “PLEASE TYPE ‘TTY* IF YOU ARE AT AN INTERCOM 
TERMINAL." 

be. “DO YOU WANT AN EXPLANATION OF THE PROGRAM?" 

ce “YOU WILL NEED ROOTS AND/OR FACTORS OF THE 
NUMERATOR AND DENOMINATOR OF THE TRANSFER FUNCTION. 
IF YOU DO NOT HAVE THESE ROOTS AND/OR FACTORS, 
TYPE ‘POLY’. OTHERWISE, TYPE ‘NO*°.™ 

d. “TYPE THE SYMBOLIC NAME OF THE RESPONSE YOU DESIRE. 
EXAMPLE: PARTL" 

ee “IF YOU ARE FINISHED, TYPE ‘STOP’. IF YOU DESIRE 
TO USE ANOTHER SUBPROGRAM, TYPE THE CORRECT 
SYMBOLIC NAME FOR THAT SUBPROGRAM." 

Typing ‘POLY’ in c above will alert the executive overlay 
to call Overlay(CCPCSD,4,0), which is a subprogram to factor 
any polynomial. Typing either ‘ROOTL‘, ‘FREQR', ‘PARTL*, or 
*"POLY’ in d or e above will alert the executive overlay to 
call Overlay(CCPCSD,1,0), Overlay(CCPCSD,2,0), Overlay(CCPCSD, 
3,0), or Overlay(CCPCSD,4,0), respectively. And, as might be 
expected, typing ‘STOP’ in e above will terminate the program. 
The flow chart in Fig. 4 illustrates the operation of the 


CCPCSD program as controlled by the executive overlay (Overlay 
(CCPCSD,0,0)). 
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(START 
+¥a 


FACTORS YES 
EEDED 


0 EXECUTH 
POLY 


EXECUTE 
POLY 


Fig. 4 


Flow Chart of the CCPCSD Operation 
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Subprogram Overlays. The subprogram overlays (Overlay 
CCPCSD,1,0) - ROOTL; Overlay(CCPCSD,2,0) - FREQRs; Overlay 
(CCPCSD,3,0) - PARTL; and Overlay(CCPCSD,4,0) - POLY) are 
primary overlays and are called up by the executive overlay 
(Overlay(CCPCSD,0,0)). They may be considered as totally 
separable from one another, but, at the same time, not totally ] 
independent when considering their individual functions as 
used in control system design and analysis. 

Overlay(CCPCSD,1,0). Overlay(CCPCSD,1,0) 

represents the subprogram ROOTL, which is a program developed 
to determine the root locus of a given transfer function by 


finding the solution to its characteristic equation 


1 + KG(s)H(s) = 0 (1) 

or 
K(s-21) «++ (S-Zm-1) 
SCS ei (2) 
(s-p1)+++(s-pn) 

as a function of K (K varying from 0 to t infinity). Appendix 
A may be referred to for more specific information about 
ROOTL's theory and operation. 

Structurally, ROOTL consists of the overlays and 
subroutines shown in Fig. 5. The primary overlay (Overlay 
(CCPCSD,1,0)) acts as an executive overlay by controlling the 
overall flow of subprogram ROOTL.- The three secondary 


overlays provide the specific tasks of setting up for a 


calcomp plot, printing and plotting the root locus, and 


determining the roots of interest for a specified gain. t 
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Overlay(CCPCSD,1,0) 
Program ROOT10 


Primary Overlay 
(Directs flow 
of ROOTL) 
Subroutine BANG 
Subroutine BOX 
Subroutine GANG1 
Subroutine BLEND 
Subroutine SMULR 
Subroutine ANG1 


Overlay(CCPCSD,1,1) 
Program ROOT11 


Secondary Overlay 
(Sets up Calcom 
Plot) 

Subroutine CNTER 


Subroutine DNTER 
Subroutine GROUP 


Overlay(CCPCSD,1,2) 
Program ROOTS 


wee ewe eww ew me ew ew Meee 


Secondary Overlay 
(Determines Roots 
of Interest for 
Specified Gain) 

Secondary Overlay 
(Trace Root 
Locus, Print, 
Plot per Option 
LL Code) 


Overlay(CCPCSD,1,3) 
Program ROOT12 


Subroutine BREAK 
Subroutine SEEK 


ee ee eee 


Subprogram ROOTL Overlay Structure 


Overlay(CCPCSD,2,0)- Overlay(CCPCSD,2,0) represents 
the subprogram FREQR, which will provide a polar plot or Bode 
plot frequency response for the given transfer functions G(.) 
and H(.). (The arguments G(.) and H(.) can be either s=jw or 
z=exp(jwT), where w, omega, is in radians per second and T is 
the sample period in seconds.) Subprogram FREQR, Overlay 
(CCPCSD,2,0), consists only of a primary overlay, but it has 
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six specialized subroutines to complete its task (Fig. 6). 


Overlay(CCPCSD,2,0) 
Program FREQR 


Subroutine BODPLOT 
Subroutine POLPLOT 
Subroutine POLYVAL 
Subroutine POLARD 
Subroutine POLYRD 
Subroutine POLYMUL 


Fig. 6 


Subprogram FREQR Structure 


Overlay(CCPCSD,3,0). Overlay(CCPCSD,3,0) represents 


subprogram PARTL, which will calculate the partial fraction 


expansion coefficients of a transfer function of the form 


K(st+a ,+jb1) (stagt+jbo)...(stamtjbp) 63) 


(stg) *(s+01+Jjd1) (stc2t+ jd)... (ste,+jdy) 


print the time function of the transfer function, and tabulate 


or plot the time response. Similar in structure to Overlay 


(CCPCSD,2,0) for subprogram FREQR, Overlay(CCPCSD,3,0) contains 


only a primary overlay, along with one subroutine and one 


FUNCTION routine (Fig. 7). 


Overlay(CCPCSD,4,0). Overlay(CCPCSD,4,0) is the last 


overlay to consider. It represents subprogram POLY, which as 
its only function, calculates the roots of a polynomial 
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Overlay(CCPCSD, 3,0) 
Program PARTL 


Subroutine POLAR 
FUNCTION FT 


Fig. 7 
Subprogram PARTL Structure 


equation of the form 
P(x) = Ayx™ + AoxPl +...4 AnX + Ansa = 0 - (4) 


It, too, is structured with only a primary overlay, subroutine, 


and FUNCTION routine (Fig. 8). 


Overlay(CCPCSD,4,0) 
Program POLY 


Subroutine DMULR 
FUNCTION RESID 


Fig. 8 


Subprogram POLY Structure 


Standardization of Specific Program Areas 

As noted in Chapter I, each of the subprograms (ROOTL, 
FREQR, PARTL, and POLY) had different input requirements 
(Table II, pages 13 and 14) and output formats, along with 
different procedures to begin and stop the programs. The 


following subsections describes the specific areas of 
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each program that have been standardized. 

Inputs. The inputs for FREQR, PARTL, and POLY are 
basically the same as the original programmers had written 
them. Each subprogram consists of printed statements that 
"ask" the operator to submit the specified input in a 
required format. 

Only the order and coefficients of a desired polynomial 
are needed as inputs for POLY. PARTL and FREQR basically 
require the factors of the numerator and denominator of a 
transfer function, plus specific parameters which control the 
type, quantity, duration, and limits of the tabulations, 
printouts, and/or plots. These specific parameters are again 
“asked for" by the subprograms. 

ROOTL, on the other hand, required substantial alteration 
to allow standardization with the other subprograms. First 
of all, the front end of Overlay(CCPCSD,1,0) was changed to 
include a list of options (if the operator desired). The 
choice of inputting all of the parameters in either one 
NAMELIST statement, or in a step-by-step manner (the sub- 
program “asking" for the parameters by associative groupings) 
was added to assist the operator. Finally, the signs were 
changed for the parameters XP(.) (real poles), YP({.) (imag- 
inary poles), XZ(.) (real zeros), and YZ(.) (imaginary zeros) 
to allow ROOTL to accept factors instead of roots. 

Therefore, each subprogram has the capabilities of 
providing a list of options, of "asking" the operator to 


input specific parameters, and of accepting factors of the 
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numerator and denominator of the transfer function instead of 
roots. 

Termination. Although the actual method of terminating 
each of the subprograms seemed small and near insignificant, 
standardizing the method has been accomplished. For each of 
the subprograms (ROOTL, FREQR, PARTL, and POLY), the method 
for termination is to type a '0' (zero) and return the 
carriage. A note of caution: typing a zero at any point in 
the program will not necessarily cause termination. The 
program must present the list of options which include 
termination before the operator types the zero. However, to 
terminate the total CCPCSD program (not just the subprogram), 
the operator may type a '%A‘. All prior information and 
calculated results are lost once the Za is entered and the 
program stops. 

Data Structure. The ideal data structure for this 
consolidated computer program must be one in which data, such 
as the numerator coefficients (zeros), denominator coefficients 
(poles), gain constant, and other similar parameters, are 
entered one time - all of the subprograms using this one-time 
input - and that data changes could be made to only the 
parameters desired to be changed without effecting any of the 
remaining parameters. However, for reasons stated in the 
first section of this chapter, the data structure for each of 
the subprograms was not altered towards achieving a standardized 
structure. Subprogram ROOTL makes use of the NAMELIST 


statement for parameters that are entered as inputs, called 
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out for processing, put back as either the same parameter or 
as an altered parameter, and used for tabulations and/or 
plots as required. COMMON statements are used as vehicles 
for data transfer from overlay to subroutine and overlay to 
overlay. Subprogram FREQR, PARTL, and POLY made use of 
COMMON statements only. If a change in a parameter is desired, 
the subprogram must be re-started and all of the data must be 
entered; this is unlike ROOTL's NAMELIST data capability of 
changing only selected parameters (knowing that all others 
will remain unchanged and at their initialized value). 
Standardizing the data structure for the CCPCSD program 
remains to be a complex task yet to be fully accomplished. 
Chapter IV discusses some recommendations which affect the 


data structure selection. 
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III. Realization, Testing, and Results 


Once a total algorithm and flow chart analysis had been 
formulated, and the total overlay structure for the CCPCSD 
had been determined, the job of realization of the algorithm 
as an efficient, usable program became a reality. The 
following subsections contain a discussion concerning the 
realization of the total algorithm, the testing criteria and 


methods, and the results obtained from the testing. 


Realization 
In order, first, to make sure that continuity throughout 
all of the subprograms would be accomplished, the program 
statement for the executive overlay (Overlay(CCPCSD,0,0)) was 
modified to include all inputs, outputs, and tape files. It 
reads: 
PROGRAM CCPCSD(INPUT#100B, OUTPUT=100B, ANSWER, PPLOT, 


CFILE, PLOT, TAPE5=INPUT, TAPE6=ANSWER , TAPE7=OUTPUT, 
TAPE8=PPLOT , TAPE9=100B) 


Next, to incorporate the modified file system, the input 
statements for the subprograms ROOTL and POLY were updated 
where necessarye Subprograms PARTL and FREQR did not require 
any modification to their file system. Only the executive 
overlay (Overlay(CCPCSD,0,0)) contained the program statement 
with the specified file names required for all of the overlay 
levels in the CCPCSD program. Hence, each of the separate 
subprograms were properly corrected for consolidation. 

Overlay statements were written; "return" statements 


were substituted for "stop" and "end" statements (as needed); and 
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all COMMON and data statements for each of the subprograms 
were checked for duplication which could cause erroneous 
results (i.e., storing and manipulating different parameters 
from the same locations - unintentionally). 

*" The executive overlay (Overlay(CCPCSD,0,0)), subprogram 
ROOTL, and subprogram POLY were “put together" first. The 
errors were corrected, and finally these three parts function- 
ed properly together. (Testing is discussed in the following 
subsection.) Subprograms FREQR and PARTL were added to the 
consolidated program sequentially, and, after each was added, 
the same error-correcting test procedure was applied until 


the total CCPCSD program functioned without errors. At this 


stage, the CCPCSD program was ready for testing. 


Testing 


Testing centered basically around four areas: 
ae inducing errors intentionally 
b. using each option for every subprogram 
c. checking for correctiveness of results by 
comparing with a set of controlled test problems 
d. making sure that the termination option functioned 
properly. 
If plots or printed outputs could be "sent" to a central 
location, (i.e., AFIT computer room, building 640), they 
were indeed "sent," and were verified as reaching that 


location by physically picking them up and checking them 


for correctness. 
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Executive Overlay (Overlay(CCPCSD,0,0)). Each option 


in the executive overlay was tested for proper functioning, | 
and each performed properly without fault. Intentional 

errors, such as typing a symbolic name incorrectly, returning 

the carriage without any information being previously entered, 

and omitting part of an instruction, were induced and the 

response was noted. Error statements were printed out each | 
time an error was entered intentionally, along with a comment 

for the operator to “try again by typing...". Because the 

executive overlay must maintain the overall flow of the CCPCSD 

program, it was extremely important that no error introduced, 

by mistake or intentionally, would cause the program to jump 

to another location, or halt without proper cause. The error 

checks tested operated satisfactory. The executive overlay 

was not tested for “correctness of results," as it does not 

perform any calculations, but the terminating operation was 

performed to insure that the total CCPCSD stopped and that a 

CP time was given. Hence, the executive overlay (Overlay 

(CCPCSD,0,0)) was subjected to each of the applicable test 

areas. 

Subprogram Overlays. Initially, each of the subprograms 
were test for termination upon command. Next, to insure that 
all of the options for every subprogram worked, and that each 
worked correctly, the prior-tested examples contained in the 
original user's guide (ROOTL, FREQR, PARTL,and POLY) were used 
as the controlled test problems. Every option was tested, and 


the results of the CCPCSD program were compared with the 
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results of the sample problems. Finally, intentional errors 
were introduced randomly throughout each subprogram. Some 

of the errors used were: exceeding the order of a system 
beyond its capability; typing in too much data at one time 
(i-e.,t00 many coefficients, constants, or other parameters) ; 
typing an option number that did not exist; and creating a 
situation in which the computer had "trouble calculating the 
results within the limits/bounds" (i.e., very small numerator 
and extremely large denominator of a transfer function with 


a division process taking place). 


Results 

The results of testing the CCPCSD program were indeed 
favorable and encouraging. Each of the subprograms, plus 
the executive overlay, did terminate upon command. At any 
point in the program, typing the "ZA" did cause complete 
program termination - as predicted. 

All of the options for every subprogram operated as 
planned; each of the problem results obtained from the CCPCSD 
program did compare exactly with the results of each of the 
sample problemss and, finally, the error checking capability 
of each subprogram proved adequate, but not optimal. Common 
errors (wrong options, too many constants) were "caught" by 
a subprogram, and the operator was given instructions to "try 
again;"” however, errors forcing equations to become mathemati- 


cally unsolvable caused the total CCPCSD program to be 


terminated. 


Although the greater portion of the CCPCSD program worked 
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well, the subprogram ROOTL does contain one annoying 
characteristic. The operator is given the choice to enter 


the data and parameters either as one NAMELIST statement, or 


SS ST es 


as a step-by-step grouping of parameters, with each grouping 
being "printed out" for the operator to do with as he please. 
Accomplishing the one-time NAMELIST data is relatively simple 
if one knows what he wishes to input prior to typing the 
statement. Accomplishing the step-by-step procedure can be 
annoying, but its procedure is still simple. As an example, 
the following statement may be printed out for the operator: 
“ENTER NUMBER OF LOCUS POINTS COMPUTED, ‘JK='3 
DAMPING RATIO, *ZETA="; AND STEP-SIZE ON RADIAL 
SEARCH FOR GIVEN ZETA, *RAD='." 

If the operator does not wish to change any of the 
parameters mentioned, he must start in column two, and type 
*$INPUD $". Hence, regardless of whether or not data is 
entered, the operator must start in column two and type 
*$INPUD’, then skip a space and type either another '$° for 
no data change, or type the data and a ‘'$" at the end of the 


data. The process is at times annoying, but certainly not 


unbearable. 
All in all, the results from testing the CCPCSD program | 
indicated that the program operated as planned, and that it 
| provided correct results (compared to the testing sample 


problems). The CCPCSD program is usable. 
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IV. Conclusions and Recommendations 


This chapter provides the reader with the conclusions 


and recommendations for the CCPCSD program. 


Conclusions 

Completion of the Consolidated Computer Program for 
Control System Design (CCPCSD) is definitely a positive step 
towards providing the control engineer and/or engineering 
student with the optimum computer-aided design toole Although 
the CCPCSD program is not the “optimal program," it is 
definitely a working program, and it can be used in its 
present state for field use in control system design and 
analysis work. 

The overlay structure insures that the core used at any 
time is at an absolute minimum. The overlay structure also 
demonstrates current state of the art practices for develop- 
ing large program/subprogram combinations, and it possesses 
the capability to add other programs/subprograms as desired 
with little modification. In short, the overlay structure 
is effective. 

In the view of being a useful product, the CCPCSD does 
meet the following criteria: 

ae It works effectively, and it has understandable 
instructions. 

be. It provides correct results (calculations, plots, 
tabulations). 


ce It contains error diagnosis/statements. 
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d. It is usable on computers with Fortran IV (Extended) 


} language (CDC 6600, in particular). 


The CCPCSD, however, does not meet the criteria for a 
single data structure that (1) enables the operator to enter 
the input data one time - this input satisfying all of the 
subprograms input requirements; and (2) enables information to 
be passed from one subprogram to another. 

The CCPCSD offers considerable advantage (time and 
convenience) to the engineer or student by providing each 
design tool (root locus, frequency response, and time response) 
at his fingertips (one call up of the computer yields all of 
the programs). And, based upon the results of this thesis 
(relating to the criteria and tests), the CCPCSD is a useful 
program for control system design and analysis. It must now 
be “tried and proven" by serious engineers and/or students - 


improving its performance wherever possible. 


Recommendations 
Two distinct areas for immediate/near-future development 
are recommended: 
1. To continue with the present CCPCSD, improving it 
and expanding its capabilities. 
2. To convert the present CCPCSD into an interactive 
graphics package. 


Case 1. If case one is selected, the data structure 


should be attacked with a goal to make one data structure 


which is used by all of the programs in the CCPCSD. Provisions 


should be made to accept added programs without any affect on 
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the data structure - a challenging job. Also, the CCPCSD 
should be expanded to accomplish both continuous and digital 
control system design and analysis. The main overlay should 
contain the necessary logic, with user-instructions for the 
added capability. The CCPCSD should also be capable of being 
run as BATCH jobs. 

More programs, as listed in Chapter I, should be added 
to the CCPCSD, as long as duplications are removed and non- 
productive programs are eliminated. Prospective avenues for 
improving and expanding the present CCPCSD are almost limitless. 

Case 2. If case 2 is selected, the task of converting the 
CCPCSD to operate from a graphics terminal would involve 
restructuring both the data structure and some of the CCPCSD 
architecture. However, there is a graphics package already 
developed for program ROOTL (called GROOTL; available in the 
AFIT library of the CDC 6600 computer system). This graphics 
package could be a good starting point for a CCPCSD graphics 
package. Regardless, a graphics package with even the present 
CCPCSD capabilities is definitely an option urgently needed 
by engineers and/or engineering students. 


Long Range Goals. Long range goals could call for the 


CCPCSD to be capable, first of all, of operating BATCH, at an 
intercom terminal, or from a graphics terminal/console. As 
mentioned before, the amount of inputs required should be at 
an absolute minimum, and they should be entered only one time 
to accomplish each task for all of the programs. 


Further, the CCPCSD could be expanded to do several tasks 
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both within and without the realm of control system design 
and analysis. The CCPCSD could be expanded to do: 
a. synthesis of control systems 
b. block diagram manipulations (build-up and 
reduction) 
ce optimal estimation and control design (Kalman 
filter design) 
d. statistical analysis 
e. continuous-to-digital and digital-to-continuous 
transformations 
f. specific filter designs (Butterworth, Chebyshev, 
Finite Impulse Response) 
Z- compensation networks - design and analysis 
There are already algorithms that have been developed to 
accomplish some of the tasks mentioned above. But, actually, 
before one accepts the challenge of developing the CCPCSD to 
accomplish all of the tasks listed, the "ground floor" must 
be done first---attack the data structure; insure that extra 
programs can be added without altering the data structure, 


the main CCPCSD, and, if possible, the program being added; 


and make the CCPCSD concept totally user-oriented and simple 
to understand. Now the executive overlay (Overlay(CCPCSD,0,0) ) 


can be shaped with the necessary logic to accomplish each 


ape Se ene 


newly added task: step-by-step. (Note: All efforts to expand 
the capabilities of the CCPCSD should, of course, be coordin- 


ated with knowledgeable control systems personnel in both the 


field and the academic environment. ) 
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An evaluation of the algorithms (programs) already 
available (by job and effectiveness---excellent, adequate, 
poor) might seem worthy, but past experience has shown that 
it is nearly impossible to keep track of these algorithms due 
to changes in location, task, updating, and growth. The 
confidence factor becomes short termed. Therefore, to help 
eliminate any frustrating experiences for some other soul 
who might “trust” that which is in print as being totally 
correct and up-to-date, the evaluation of the algorithms is 
not included. 

", « « up-to-date information must be 


updated frequently to insure its 
validity. . ." (unsigned) 
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BRIEF DESCRIPTION OF PROGRAMS 


ROOTL, FREQR, PARTL, AND POLY 
(DECEMBER 1976) 
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Brief Description of Programs 
ROOTL, FREQR, PARTL, and POLY 


This appendix is indeed a brief description of each of 


the programs - ROOTL, FREQR, PARTL, and POLY. Initially, the 
approach to this appendix was to obtain every bit of infor- 
mation about each of the programs, and then to write a brief, 
but thorough, description of each program using the informa- 
tion that had been gathered. However, it is determined that 
the original user's guides for each of the programs is an 
"authority" for not only its description, but also for its 
operation. Hence, with an intent not to draw from that which 
is already in the original user's guides (duplication of 
effort is both unprofitable and unnecessary), but yet to 
provide a better understanding of the programs in their 
present state (in the CCPCSD), it is decided instead to make 
the reader aware of each user's guide, and to provide all of 
the changes to each program since incorporating each into the 


CCPCSD. 


ROOTL (Root Locus Program) 
The user's guide for program ROOTL is: 
NAMEs ROOTL USER'S MANUAL 
& DIGITAL COMPUTER PROGRAM TO CALCULATE 
AND PLOT THE ROOT LOCUS 


DATE: March 1975 


DEPARTMENT: Air Force Institute of Technology (AFIT/EN) 
Wright-Patterson Air Force Base, OHio 45433 
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The following changes have been made to ROOTL: 

| 1. Factors instead of roots are now entered for poles 

| and zeros (i.e., for poles (s+3)({s+6): BEFORE - 

| XP(1)=-3,-6 (as roots); NOW - XP(1)=3,6 (as factors). 

2. The operator is provided with a list of options (if 

i he desires). 

3- The operator may elect to enter the input parameters 
either in one NAMELIST statement, or in groups of 
parameters in the form of a step-by-step procedure 
- several NAMELIST entries (each “asked" by the 
computer). For each entry, a ‘$INPUD' must start 
in column two, and a ‘$' must be added at the end 
of the entry. 

EXAMPLE: a. Regular one~NAMELIST entry: 
$INPUD AA=12, BB=13,CC=-10,DD=-14, 
N=2,M=1,XP(1)=2,4, YP(1)=0,XZ2(1)=3, 
YZ(1)=0$ 


be Reply after being "asked" about 
option by the step-by-step procedure: 


$INPUD LL=1$ 
c. Wanting no change to parameters 
being "asked" by the step-by-step 
procedures 


$INPUD $ 


FREQR (Frequency Response Program) 
The user's guide for program FREQR is: 


NAME: FREQR 
FREQUENCY RESPONSE PROGRAM 
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DATE: November 1975 
DEPARTMENT: Air Force Institute of Technology (AFIT/EN) 
Wright-Patterson Air Force Base, Ohio 45433 
Program FREQR remains relatively unchanged with the only 


addition being a list of options (operator requested). 


PARTL (Time Response Program) 
The user's guide for program PARTL IS: 
NAME: PARTL 
HEAVISIDE PARTIAL FRACTION EXPANSION AND 
TIME RESPONSE PROGRAM 
DATE: December 1974 (Revised) 
DEPARTMENT: Air Force Institute of Technology (AFIT/EN) 
Wright-Patterson Air Force Base, Ohio 45433 
The version of program PARTL that is presently in the 
CCPCSD is, unfortunately, not the latest AFIT version. 
However, the only change that the updated version has 
incorporated in it is in the format of the coefficients for 
the partial fraction expansion. (The version in the CCPCSD 
was received from the AFIT CDC 6600 computer library as the 
"latest" version of PARTL.) 


Present (CCPCSD) PARTL: (Coefficient printout) 


ROOT POWER COEFFICIENT 
REAL IMAG REAL IMAG 
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Updated version of PARTL: (Coefficient Printout) 


FACTOR POWER COEFFICIENT 
REAL IMAG REAL IMAG MAGNITUDE ANGLE 
i It is quite possible that the truly updated version of 


PARTL is available now. 


j The only change to program PARTL is the termination 
, procedure. A 'O' (zero) is used to terminate normally instead 
of a '6* (six). Also, the operator must remember to dispose 


his plots to the calcomp plotter. 


POLY (Polynomial Factoring Program) 


The user's guide for program POLY is: 
NAME: POLY 
CDC 6600 PROGRAM TO FIND THE ZEROS OF 
A POLYNOMIAL 
DATE: October 1974 (Revised) 


DEPARTMENT: Air Force Institute of Technology (AFIT/ENC) 
Wright-Patterson Air Force Base, Ohio 45433 


Program POLY does not have any changes or additions since 


its incorporation into the CCPCSD program. 


It should be noted that, even without the program 
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descriptions or the original user's guide for each of the 
programs, programs POLY, PARTL, and FREQR (in the CCPCSD) 


could be used satisfactorily by the operator. ROOTL is 


more complicated and, because of its input requirements, 
requires the user's guide as a reference for the symbols 
(LL, GTOL, GANE, XP(1), and others). These input symbols 
may be foreign to the operator. Therefore, the user's 
guides for programs ROOTL, FREQR, PARTL, and POLY should be 


obtained for references before using the CCPCSD. 
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APPENDIX B 


USER'S MANUAL FOR THE CONSOLIDATED 
COMPUTER PROGRAM FOR CONTROL SYSTEM 
DESIGN (CCPCSD) 


(DECEMBER 1976) 
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to the Operator 
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CCPCSD 
USER'S MANUAL 


Introduction 

The CCPCSD is developed to be completely user-oriented. 
With this in mind, an engineer or student need only know 
how to call it up (if it is already in the CDC 6600 computer 
library), and what commands to give the computer to begin 
executing the program. Therefore, it is assumed that the 
CCPCSD is in the permanent files in binary deck form and 
source deck form. A discussion follows now for using both 
forms. (Underlined commands and instructions indicate the 
computer commands; the replies from the operator are not 


underlined. ) 


CCPCSD In Binary Deck Form 
When the CCPCSD is in the CDC 6600 computer in binary 


form, the commands to use the program are as follows: 
(NOTE: PROJX is the file name for the CCPCSD.) 
PLEASE LOGIN 


LOGIN, (your problem number), (your password), (terminal 


ID number) 

COMMAND - ATTACH,PROJX,(file name PROJX cataloged 
under) ,CY=(cycle PROJX cataloged) ,ID= 
(ID number PROJX cataloged under if 
different from yours) ,PW=(password if 
used when PROJX cataloged) 

COMMAND - ATTACH,CCAUX, ID=X654321,SN=AFIT 

COMMAND - LIBRARY,CCAUX 


COMMAND - PROJX 


SO eg 
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The CCPCSD program now begins to execute. From this 
point, the operator need only follow the directions as they 


are presented, as they are completely self explanatory. 


CCPCSD In Source Deck Form 
If the source deck for the CCPCSD is in the permanent 
files, the following procedure is to be used to make the 


CCPCSD operational: (PROJX is the file name for the CCPCSD.) 


PLEASE LOGIN 


LOGIN, (your problem number),(your password) , 
(terminal ID number) 


COMMAND - ATTACH,PROJX, (file name PROJX cataloged 
under), CY=(cycle PROJX cataloged), ID= 
(ID number PROJX cataloged under if 
different from yours) ,PW=(password if 
used when PROJX cataloged) 

COMMAND - ATTACH,CCAUX, ID=X654321,SN=AFIT 

COMMAND - LIBRARY,CCAUX 


COMMAND - RU,F=PROJX,FTN 


The CCPCSD is now ready for execution. It is compiled 
(approximately 19 seconds of compilation time), and after 
being compiled, it begins execution by presenting a program 
title banner and the statement, "PLEASE TYPE ‘TTY’ IF YOU ARE 
AT AN INTERCOM TERMINAL." Again, the operator need only 
follow the directions as they are presented, as they are 


completely self explanatory. 


The executive overlay (Overlay(CCPCSD,0,0)) of the 
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CCPCSD presents the following directions, questions, statements, 
and explanations in the order given below: 
ae "DO YOU WANT AN EXPLANATION OF THE PROGRAM? TYPE 
*YES* OR ‘NO*.* 


b. If your reply is ‘YES', the following explanation is 
presented: 


“YOU ARE ABOUT TO BEGIN A CONSOLIDATED COMPUTER 
PROGRAM WHICH CAN BE USED AS AN AID IN DESIGNING AND 
ANALYZING CONTROL SYSTEMS. YOU MUST HAVE YOUR SYSTEM 
REDUCED TO A SINGLE TRANSFER FUNCTION OF THE FORM: 


| (S + P,) ece (S + Py) 


WHERE K=GAIN CONSTANT, Z=ZEROS, P=POLES OF THE 
SYSTEM; OR OF THE FORM: 


K (A, XM + AaxM-2 4 00. + AMX + Ayer 


(By XN + BoxN-2 + 00. + ByX + Byyy 


IF YOU HAVE THE LAST FORM SHOWN, YOU WILL BE GIVEN 
AN OPPORTUNITY TO USE PROGRAM ‘POLY TO OBTAIN FACTORS 
(ROOTS) OF THE NUMERATOR AND DENOMINATOR FOR YOUR 

i TRANSFER FUNCTION. THEN YOU WILL BE PROVIDED WITH 

A LIST OF THE INDIVIDUAL SUBPROGRAMS THAT ARE PRESENT- 

LY AVAILABLE FOR YOUR USE. THE INPUT REQUIREMENTS 
WILL BE SPECIFIED AT THE BEGINNING OF YOUR RUN. AT 
THE END OF EACH RUN, YOU WILL BE GIVEN THE CHOICE. TO 
STOP, CONTINUE WITH THE PRESENT RUN USING NEW DATA, 
OR GO TO ANOTHER SUBPROGRAM. IN ANY CASE, YOU WILL 
BE. PROVIDED THE INITIAL LISTING OF SUBPROGRAMS ONLY 
AT THE BEGINNINGs SO, COPY THE LIST AS SOON AS IT IS 
SHOWN IF YOU INTEND TO DO MORE THAN ONE DESIGN." 


ce. " YOU WILL NEED THE ROOTS AND/OR FACTORS OF THE 
NUMERATOR AND DENOMINATOR OF THE TRANSFER FUNCTION. 
IF YOU DO NOT HAVE THESE ROOTS AND/OR FACTORS, TYPE 
*POLY'. OTHERWISE, TYPE 'NO'. (POLY WILL BE 
AVAILABLE AGAIN AS A SUBPROGRAM.)" 


de " THE FOLLOWING SUBPROGRAMS WITH EXPLAINED OUTPUTS 
ARE AVAILABLE: 
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PARTL...PARTIAL FRACTION EXPANSION AND TIME 
RESPONSE OUTPUT 

FREQR...FREQUENCY RESPONSE WITH POLAR PLOT OR 
BODE PLOT OR BOTH 

ROOTL..-ROOT LOCUS WITH PRINTS OR PLOTS OR BOTH 

POLY....DETERMINES ROOTS OF POLYNOMIAL 


TYPE THE SYMBOLIC NAME OF THE RESPONSE YOU DESIRE. 
EXAMPLE: PARTL."” 


ee Once you have finished using any one of the programs 
shown in d above, the following statement is presented: 


“ IF YOU ARE FINISHED, TYPE ‘STOP'. IF YOU DESIRE 
TO USE ANOTHER SUBPROGRAM, TYPE THE CORRECT SYMBOLIC 
NAME FOR THAT SUBPROGRAM." 
| 
Each of the statements shown above is easy to understand, | 


and the operator should not have any problem directing the 


CCPCSD with these statements. 


Do's And Dont‘s 
Do: ae Make sure the CCPCSD is in the permanent files 

before attempting to attach the program. Know 
if the CCPCSD is in source or binary form. 

be. Remember to attach the auxiliary calcomp routines 
(CCAUX) and to LIBRARY,CCAUX. 

c» After commanding the CCPCSD to stop, always check 
FILES to make sure the file PLOT is disposed. If 
it is still present, type DISPOSE,PLOT,PT=IBB. 


Don'ts: 
ae Do not make any mistake while entering the input 


data into subprogram ROOTL. This will cause the 
total CCPCSD program to terminate. 
b. Do not forget to double check each entry you make 


before returning the carriage. 


B-4 


ie 


GE/EE/76D=38__ 


Sample Problem 
The following sample problem demonstrates the usefulness 
and versatility of the CCPCSD. I 
The system to be analyzed is assumed to be described by 


the equation 


4 
s(s@ + s+ 1)(s@ + 0.45 + 4) 


C(s) 


= 4 
s(s + 0.5 © j0.866)(s + 0.2 t j1.99) 


File ANSWER is connected to obtain the printed output 

of the partial fraction expansion from subprogram PARTL. 
Options 1 (tabular listing) and 4 (calcomp plot) are chosen 
from subprogram PARTL. Option 1 (begin new problem), -1 | 
(open-loop response, tabular listing), and -3 (calcomp plot 
of Bode diagram of the frequency responce) are chosen from 
subprogram FREQR. Option 3 (root locus, calcomp plot) is 
chosen for subprogram ROOTL. For the executive overlay, the 
explanation of the CCPCSD is printed out. For each of the 
subprograms, the list of options is printed out. The plot 
file (PLOT) is not disposed at the end of the total run, 
because subprogram ROOTL automatically disposes the file. 

| (If subprogram ROOTL is not used, then the operator must 
dispose the plot file by giving the command DISPOSE, PLOT, PT= 

| IBB before LOGOUT.) The terminal printout and calcomp plots 


are now shown. 
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COMMAND- ATTACHS FREED, OBRPIEN. Cy=SsPWl=FLOB1 


COMMAND- ATTACHs OCALA 321s SN=AFIT 
PFH ITS 

COALS 

PF CYCLE NG. = O01 
COMMAND- LITERARY «COALS 
PROTX 


COMMAND COMHECT.s ANZHER 


COMMAND FRET 


ioe ener 


FOF F SHOE ESO ESE EH EFEH EFS SEES EHEHESEEESEHEHESHE HOE HOOD 
eeeeeoee > THR T OF CONEOLIDRTED COMPUTER PROGRAM escesees 
eeeeeooer Or CONTROL TYETEM TE TIM, +eeeeeoeeeoeeoeooes 
SESS O HEE ESE EHEE EHO EEE EESEEEESHEFSE SESH EEEHOHOSCEHHEHOS 


PDERSE TYPE “Ty IP YOU “ARE AT An INTERCOM TERMINL CT) 


/ 
AeA ii aS AAR 


“PRD NANT @n EXPLANATION OF THE PROGRAM? 


ae “NES? OR “NOD-. 


SESH ESSEHESE SE SEEEEHEEEEEEESEEFHEPFESEEHEESCESESCHESEHESEECEES 

YOU APE ABOUT TO BEGIN & CONSOLIDATED COMPUTER 
PROGRAM WHICH CAN BE USED A? AN AID IN DESIGNING AND ANALYZING 
COMTPOL SYSTEMS. VOU MUST HAVE YOUR SYSTEM RFEDUCED TO A SINGLE 
TRANTFER FUNCTION OF THE FORM 


ras cecameae 


WHERE k = GAIN CONSTANT: & = ZEROEs F = POLES OF THE 2YSTEMs 
OF OF THE FORMS 
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IF YOU HAYWE THE LAST FORM SHOWNs ‘OW WILL BE GIVEN AR 
OPPORTUNITY TO UEE PROGRAM “POLY” TO OETAIN FACTORS «ROOTS: 
OF THE NLMERATOR ABD TREHOMINATORr FOr SOUR TRAMDFER FUNCTION. 
THEN ‘OL! WILL BE PROVITED WITH A-LIST GF THE INDIVIDUAL SuUE- 
PROGRAMS THAT ARE PRESENTLY AYWAILAPBLE FOR YOUR USE, THE 
INPUT FEGUIREMENT® WILL BE =PECIFIED AT THE BEGINHING OF 
YOUR Plin, AT THE EMD OF EROH Bille “YOU tWILbt BE GIWEM THE 
CHOICE TO =TORPs CONTINUE WITH THE PRESENT BUN USING HEW 
TATA, OF 6D TO ANOTHER =UBPROGRAM, IN ANY CASE: QU WILL 
BE FROVITED THE INITIAL LIZETING OF SURPROGRAM: ONLY AT THE 
BEGIANINGs SO: COPY FHE LIET AS SOON AS IT IS SHOWA IF YOu 
IHTEND TO DO MORE THAM ONE DESIGN. 

PEERS EEE EEE EHE EEE FEE HEE EHE SER EEE EEEEEHOEHEHHOD 


“OU WILt NEED THE FORTS AND-OR FACTORS OF THE 
NUMERATOR AMD DEXHOMINATOR OF THE TRANTFER FUNCTION, IF 
YOU DO HOY HAVE THEEE FOOT: AND-OF FACTORS, TYPE “POLY. 
OTHERHIZEs TYFE “nO’. «POLY WILL EE AVAILABLE AGAIN AZ A 
UEP ROGR EM. 9 


PHEOEE EE HEHEHE EEE EES EHEEEHEE SE DEFOE EHEEEEHEEEHEOS 
THE FOLLOWING SUBPROGRAM? WITH EXPLAINED GUTPUTS ARE 
AVAILABLE? 


PAPTL...PARTIAL FRACTION EXPANTION WITH TIME SESPONTE OUTPUT. 
FREOR... FREQUENCY PESPONTE WITH POLAR PLOT OF ECDE FLOT OUTPUT. 
POOTL...FOOT LOCUS WITH PRINTS OR PLOTS OF EOTH. 

FOLY.... DETERMINES FOOTS OF POLYNOMIAL. 


TYPE THE SYMBOLIC MAME OF THE PESPONTE YOU DESIFE. 
“AMPLE: PR TIEAET) 


SEEPS HSSHSSSSEHS SESH SESS HSSHEHSSESSSSHSHEEHEEEHHEHEHEEEE HEHEHE S 


ita) 


SHOES HES 
RD FOOT: AND NUMERRTORF CONS TANT 


START OF PROGRAM “PARTL< 
POLES, POWER OF REPEAT 


FOCEHESO OOOO EH 
ip HO. OF ZERR 


TYPE PERL AND IMAG PAPTS OF DENOMINATOR FACTOR. 


TYPE REAL ANT IMae PARTS OF DENOMINATOR FACTOR (TS, o, se5) 


CON IUEATE AD TUMED 
TYPE REAL AND IMAG PART? OF DENOMINATOR FACTOR {Te.1. 33) 


CON IUGATE ASSUME 


B-7 
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| FOOT POWER COEFFICIENT 


REAL IMAG FEAL IMAG 
{ yy. ie 1 1.0000 my 
.SOOno 1 ~.649516 —.245 
.S0000 1 -.e4516 .2453 
enon 1 14515 » 2544 16-01 
4 ~fooen 1 Bie le Soe Gs Sade 1E-01 
a REAL TMA MAGN T TUTE ANGLE 
i i, fn 1 1.0000 o.oo 
i Sone 1 691231 8.347 
1 .anoon { S313 44e 
H 220g S90 1 15042 eot 
i 2208 coo pen ANS 1 1atde eu 
i THE TIME FUNCTION 12 
i PrTis 
; 1. 0000 T? 
i Ef Sir S66 OH #T+ 245.5472 
T? SEIMN€ F.9900 7s P85 0C015 


CALCULATIONS COMPLETE 

FOF TAELILAP LISTING TYPE 1 
FOR TELETYPE PLOT TYPE 2 
EOP PRINTER PLOT TYRE 2 
FOe FCALOOMP PLOT TYPE 4 
FOr ANOTHER PROBLEM TYPE § 
TO TERMINATE TYPE i 

TYPE oFT ror) 


TYPE INITIAL TIMEs LISTING TIME DURATION, DELTA TIME.G@ss..5) 


T FT 


REE vi ern er lr SPS IEA OREN tn TATE 


. = 
.StkKoo oo 
1, 0000009 
ey Ade 


« 
<a te fe Cae 


4. connann Sa Fe, 

4, 5000007 1.0151548 

SS onnooon .27995idie 
TYPE oPTIO“®™ 


TYPE INTTIAL TIME. PLOT murat ton.Gs5) 


TYPE TITLE - SO CHARACTERS MA 
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TYPE MO. OF CHARACTERS: INCL SPRCES.29 


TPE ofr org) 
x eae nee END OF PROGRAM “PARTL“-------- 


PERE HEE EEE EEE HEE EEE EE EEEEEE EE FEE OEEEHEEEEOEHOS 
TF ¥OU ARE FIHESHEB: TYPE “STGP. IF YBU DESIRE FQ USE 
ANOTHER =URPRPOGRAM: TYPE THE CORRECT ='MEOLIC HAME FOR THAT 


TPE R OGRA , 


SRESSSEES EEE SEE ESSE ESESESHE SEES ESEHEEEHESEHEE SHE EHE 


START OF PROGRAM -FREDR  Deeessoecesece 


SPSS CHE OES 


DO YOU WAHT A LIST OF OFTION= AVAILABLE FOR “FREGRE“* 


TYPE -YES* He “ho. 


FRESE EEE EEE EE EEE EEE EE EE EFEHEEEHE EEE EEEEEEEHEHEHE SEE 
THE FOLLOWING OPTION] APE @VATLABLE FOR PROGRAM “FREGR:: 


1...170 BEGIN A NEL! PROBLEM. INFUT OF Gelids OR Gees, 
-1...FOLLOWED BY Ww COMEGAYS CALCULATES GeJW) USING FUNCTION 
ALREADY PERD INTO MEMORY AFTER OPTION 1. 
2...CLOSED-LOOP RESPONSE: Cee Redd, 
». PRODUCES TTY PLOT OF OPTIONS -1 OF -@> OF BOTH. 
-2...PRODUCE? CALCOMP PLOT OF BOLE DIAGRAM «FREO PETPONSE. 
4...70 PEAD IN AB Heli). FEEDBACK TRANSFER FUNCTION. 
S...ADDS A TRANSPORT LAG TERM <EcExP JWT?) TO Geno, 
eee LHELIT HEM FORWARD GAIN CONSTANT ONLY, 
-6...INPUT NEM FEEDBACK GAIN CONSTANT ONLY. 
7...ALCOWS AUTOMATIC DISPOSE BODE PLOTS TO BLDG 640, “BR*. 
9,..T0 TEE PRESENT Gehds HOS3s DF Ge2) FUNCTIONS. 
~11...SAME AS -1+ EXCEPT G¢Z) IS CALCULATED. 
~12...3AME AZ -2) EXCEPT CLOSED-LOOP Z-DOMAIN If CALCULATED. 
15...70 2ET A SAMPLE PERIOD FOR THE SAMPLED DATA SYSTEM. 
Oe.s CAUSES THE PROGRAM TO S10P. 
FEES SSESESESESE SHE SESE HE EHEEEEHEEEHEEEESECEH HHH CHES 
TYPE OPTION HUMBER -- @ 


FORWARD TRANZFER FUNCTION --— oer 


TYPE GAIN CONSTANT --@ 


Se ea. eee 


GE/EE/76D-38 


BAIN CONSTANT = 4.000800 


TYPE ORDER OF NUMERATOR --@ 
TYPE HUMBER OF FACTORS OF A GIVEN DRDER --() 


TYPE ORDER OF THOSE FACTORS -&® 


TYPE 1 -CHEFFICTERT <S> 


COEFFICIENT *? OF MUMERATOR 


1. 00n0one+hn Se he 


TYPE ORTER OF DENOMINATOR -€—) 
TvPE HUMBER OF FACTORS OF @ GIVEN ORDER --@ 
TYPE DPDER OF THOSE FAcTaRS --~@ 


TyFE 2 COEFFICIENT ©=) 


COEFFICIENT &=S) OF DENOMINATOR 
1,0n0onnne+oo fe 1s my St 


TYPE NUMBER OF FACTORS OF A GIVEN orrer --@ 


TYPE ORDER OF THOSE FacTORS --@ 


, COEFFICIENT 32 


COEFFICIENT «os OF DENOMINATOR 


LT. ononone+oo fe Bs 1.0n0o0one+oo Se Ls 1.a99nog0F+0n Se 


1.000000 +0n 2c 2% 4,ag00nnF-o1 fe La fg. nn0onone+o0 Se os 


TYPE OPTION HUMBER -- E) 


TT 
rs 


TO PEZTAPT PLOT APRAY =TORAGE. ENTER 


WPE INITIAL: INCREMENTAL» AND FINAL OMEGA, 
C5 


B~-10 


we 


a tuneabanenaaaeeeline 
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G -- OPEN-LOOP RESPONSE 


hd MAGA T TUDE MAG. IN DE AMGLE IM DEGREES 
ebb 10.07455e2 20. 064515 —36, 3423 
Pi 3 S051 088 3 4  SLean 
1.70 rlioSo4i t= So. 50e17 
@ a0 »~L1t F520 —{* ?4e2 
Cees 1 =3 nee 
4.30 4 ~4 bee 
4.50 1 a S41 
Slee - 6 645 
a. SH ea Sé6 
7 a = ee 


Pe 
TYPE OPTION NUMBER 


TF VOU WANT A MAG WE ot PLOT « ENTER A of 
IF YOU WANT A DE VS LOG Wt PLOT» ENTER A 1 


IF VOU WANT BOTH TYPED OF PLOTS, ENTER A 2@®© 


TYPE IN TITLE OF M-vS-h PLOT. 30 CHARACTERS MAS 


SAMPLE CCPL SO———FREGR 


TYPE IH TITLE OF DE YS LOG b) PLOT: 30 CHARACTERS MAX 


PRTEE PxBBRPLE CEPLES 


TYPE OPTION NUMBER --@ 


~----+- END OF PROGRAM ~FREGe“------- 


PPEEEE EEE EEFEEE EEE EHEEEEEEE EEE EEEEFESEEEHEFEEEEEEES 
be YOU ARE OPIMESHED. TYPE “STOP *. fe Yuu GESERE ho Use 
ANOTHER SUEBPROGRAM, TYPE THE CORRECT 2MEBOLIC MAME FOR THAT 
SUBPROGRAM, | 

| 


PEEESOP EE EHEE EE SESE HEHE SESE EHH HEE HE HEHEHE ESEEHEHEHEOESE 
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PRION Sev Env One 
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POCO COHECeOeeR: THE T CF PROGRAM “FOOTL: PeECEECHEHEE 


geacasgsssasase geasgessseds bobacasscgnaed 
rar tae se arse anae seaeae 


no YOU WAHT A LIST OF NPT IOM= “AVAILABLE FOR “ROOTL”*? 


TYPE “YES OF °NOD- 3S 


FEE HOSE EEFE OEE OE HE EHEEHOESEEEEDEEEFHOEEEEEEHEEES 
THE FOLLOWING OF TIONS ARE AVAILABLE FOR “RPOOTL: 


0...7O STOP THE PROGRAM 

COMPUTES EACH BRANIH OF THE LOCUS OF THE TRANZFER 

FUME TION OVER SPECIFIED BOUNDED FEGIOMN. TABULAR OUTPUT 
FOF BRAHCHES:s PLUS PLOT: IF DESIRED. 

Soe lMibAR TO 1" ss EXEEPT STEP STt2e CAN BE SPECIE IED. 

Sie GEMILAR TO “2s EXCEPT: ZETA: DAMPING RATIOs SPECIFIED. 

$. 5.10 INVESTIGATE PRETS OF LOCUS DF SPECIAL INTEREST. 

eee SeMILAR TO "4*s HETH BOUNDARTES DF “1" = “3s STARTING 
POINT MUS) BE SPEC LR LER. 

Joo tT RUNCHIED VERSION GE 1". DMG ROOTS GF -PHTEREST oR fh 
SPECTFIED GRIM OF INTEREST “GHHE> ‘ANE TOLERANCE <GTHl> 
ARE LISTED. MO PLOT GENERATED. STOL NOT EQUAL TO ZERO. 

feae SLMILAR TH--6" POR SPECIFIED DARPING RATIO “2ETAS>s REOTS 
BF INTEREST ARE SPECIFIED. “GAREsGTOLs AND TIME ARE 
HOY aPeEC Ie ied. 
FEE EEE EEE EE EEE EE DEE EH ERE FE EHEH EE EEEEEE EE HEHEHE EES 


_ 
. 


PERE EEE EEE EEE ERE HE EEE EERE OE EEE EEE REHEEEEEEHEHEHE HES 

MObll VOL WILL HAVE THE CHOICE OF EITHER ENTEFING THE 
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APPENDIX D 


PROCEDURE FOR ADDING COMPUTER PROGRAMS 

(ALGORITHMS) TO THE CONSOLIDATED COMPUTER 

PROGRAM FOR CONTROL DESIGN (CCPCSD) 
(DECEMBER 1976) 
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Procedure for Adding Computer Programs (Algorithms) 
to the Consolidated Computer Program for Control 


System Design (CCPCSD) 


The Consolidated Computer Program for Control System 
Design (CCPCSD) is structured to allow adding other computer 
programs without causing any substantial modification to the 
programs being added. The following procedure is prepared 
to help an individual add another computer program to the 
CCPCSD. Please read all of the procedure before starting. 

(NOTE: Caution must be exercised before the following 
procedure is started as two major limitations exist. 

a. The CCPCSD uses approximately 25»000g words of core; 
the added program must not exceed 25,000, words. 
be The maximum amount of files that can be used at 
the intercom terminal is ten. 
Hence, make sure that your program does not cause the CCPCSD 
to exceed these limitations. Also, the steps mentioned below 
do not necessarily have to be done in the order given. And, 
further, for the purpose of this procedure, it is assumed 
that the program to be added is called "PROJX," and that it 
is the fifth program in the CCPCSD.) 
STEP 1. IMPORTANT: PROJX must be capable of fully indepen- 
dent operation from an intercom terminal. (All 


of the errors must have been removed before adding 


the program to the CCPCSD.) 
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STEP 2. 


STEP 3. 


Compare all of the file names listed in the 
PROGRAM statements of the CCPCSD and PROJX. 
PROJX must now be altered, if necessary, to 
agree with the CCPCSD file names. 
EXAMPLE: The PROGRAM statement for the CCPCSD is: 
PROGRAM CCPCSD( INPUT=100B, OUTPUT=100B,ANSWER,PPLOT, 
CPILE, PLOT, TAPES=INPUT, TAPE6=ANSWER, TAPE7=OUTPUT, 
TAPE8=PPLOT, TAPE9=100B). 

Assume that the PROJX PROGRAM statement 
iss 


PROGRAM PROJX( INPUT, OUTPUT, TAPE1=INPUT, TAPE2= 
OUTPUT ,COUNT). 


a. All of the statements in the PROJX program that 
refer to TAPE1 must be changed to refer to TAPES; 


and, consequently, TAPE2 changed to TAPE7. 


From To 
READ(1,200) READ( 5,200) 
WRITE(2, 210) WRITE(7,210) 

ETC. 


b. Make a new PROGRAM statement with the CCPCSD 
files corrections: 

PROGRAM PROJX(INPUT,OUTPUT, TAPE5=INPUT, TAPE7= 
OUTPUT,COUNT). 

This step is very important, and could get rather 
tedious. If COMMON statements are used in PROJX, 
all of the file names for the COMMON statements 
in programs ROOTL, PARTL, FREQR, and POLY must be 


compared with those in PROJX. If any file names 


are identical, modify the PROJX COMMON statements 


ape a ee See eee ae eee 


en NE 
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STEP 5. 


by using new file names. (Do not forget to make 
the appropriate changes throughout program PROJX 


to reflect the new file names.) 


If PROJX does not have any COMMON statements, you 


may proceed to STEP 4. 


Now that you have finished the modifications for 
the COMMON statements and the PROGRAM statements 
throughout PROJX, test the program to insure that 


it still functions properly. Debug, if necessary. 


Remove the PROGRAM statement from PROJX and 
substitute the following statements in its place: 


OVERLAY(CCPCSD, 5,0) 
PROGRAM PROJX 


***Now you are ready to make changes to the executive 
overlay (Overlay(CCPCSD,0,0)) of the CCPCSD.*** 


STEP 6. 


STEP 7. 


STEP 8. 


(Reference STEP 2) - The file named COUNT, shown 
in the PROGRAM statement for PROJX, must be added 
to the PROGRAM statement for the executive 
overlay of the CCPCSD (i.e., ". . ».TAPE9=100B, 
COUNT)"). 


To the FORMAT statement 1005 (approximately line 
number 730), add the symbolic name PROJX, and an 
explanation of PROJX (similar to those given for 


ROOTL and PARTL). 


Statement 18 of the executive overlay reads 
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"18 IF(J.EQ.5HPARTL) GO TO 9." Insert the 
| statement “IF(J.EQ.5HPROJX) GO TO 21" after 


statement 18. 


STEP 9. Just before the END statement (approximately 
line number 1110), add the following statements: 
21 CALL OVERLAY(CCPCSD,5,0,0) 
GO TO 10 
STEP 10. Physically put the cards for program PROJX behind 
(at the end) of the cards in the CCPCSD. Hence, 


the new structure would be (in general): 


OVERLAY (CCPCSD,0,0) Executive 
OVERLAY (CCPCSD,1,0) ROOTL 
OVERLAY(CCPCSD,2,0) FREQR 
OVERLAY(CCPCSD, 3,0) PARTL 
OVERLAY (CCPCSD,4,0) POLY 
OVERLAY(CCPCSD, 5,0) PROJX 


STEP 11. Put the new CCPCSD into the permanent files, or 
library. Test the CCPCSD at the intercom terminal. 
| Debug, if necessary. Re-catalog, if necessary. 
eteeeee ee et Hee Hee He HE HHH HEHEHE HE HH 
This procedure for adding programs to the CCPCSD is 
developed to be relatively simple and easy to understand. 
However, some of the changes that must be made to the CCPCSD 
| and to the program being added should be made with care. 
Typing the changes incorrectly can cause many unnecessary 


headaches. 


Good luck. 
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